---
title: PageDescription
description: Usage instructions for the PageDescription component
---

<PageDescription>

This is a `<PageDescription>` component. It is generally used for intro text at
the top of the page using the
[type token](https://www.carbondesignsystem.com/guidelines/typography/expressive)
`expressive-heading-03`.

</PageDescription>

## Notes

For most pages, we recommend starting with a `PageDescription` followed by
`AnchorLinks` if the content is long enough. Please note that this component,
like all MDX components, is picky about white space, the line break above and
below your content is required, and if you even have an extra space on the empty
lines above/below it won’t render correctly.

## Code

```markup path=components/PageDescription/PageDescription.js src=https://github.com/carbon-design-system/gatsby-theme-carbon/tree/main/packages/gatsby-theme-carbon/src/components/PageDescription
<PageDescription>

Lorem ipsum dolor sit amet, **consectetur adipiscing elit**, sed do eiusmod tempor _incididunt_ ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

</PageDescription>
```

### Props

| property | propType | required | default | description |
| -------- | -------- | -------- | ------- | ----------- |
| children | node     |          |         |             |
